home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / Slackwar / docs / IPX-HOWTO < prev    next >
Text File  |  1997-02-23  |  77KB  |  1,894 lines
  1.   Linux IPX-HOWTO
  2.   Terry Dawson, terry@perf.no.itg.telstra.com.au
  3.   v2.2, 29 March 1997
  4.  
  5.   This document aims to describe how to obtain, install and configure
  6.   various tools available for the the Linux operating system that use
  7.   the Linux kernel IPX protocol support.
  8.  
  9.   1.  Introduction.
  10.  
  11.   This is the Linux IPX-HOWTO. You should read the Linux NET-3-HOWTO in
  12.   conjunction with this document.
  13.  
  14.   1.1.  Changes from the previous release.
  15.  
  16.   Additions:
  17.           Added some Frame Type information
  18.  
  19.   Corrections/Updates:
  20.           0x is required for IPX network address in /etc/ppp/options
  21.           Versions and locations up to date.
  22.           Some shuffling around, abstracted Printing and admin tools.
  23.  
  24.   1.2.  Introduction.
  25.  
  26.   The Linux Kernel has a completely new network implementation as
  27.   compared to other Unix like operating systems. The ability to take a
  28.   fresh approach to developing the kernel networking software has led to
  29.   the Linux kernel having support for a range of non tcp/ip protocols
  30.   being built. The IPX protocol is one of those that have been included.
  31.  
  32.   The Linux kernel supports the IPX protocol only. It does not yet
  33.   support protocols such as IPX/RIP, SAP or NCP, these are supported by
  34.   other software such as that documented elsewhere in this document.
  35.  
  36.   The IPX support was originally developed by Alan Cox
  37.   <alan@lxorguk.ukuu.org.uk> and has been significantly enhanced by Greg
  38.   Page <greg@caldera.com>.
  39.  
  40.   2.  Disclaimer.
  41.  
  42.   I do not and cannot know everything there is to know about the Linux
  43.   network software. Please accept and be warned that this document
  44.   probably does contain errors. Please read any README files that are
  45.   included with any of the various pieces of software described in this
  46.   document for more detailed and accurate information. I will attempt to
  47.   keep this document as error-free and up-to-date as possible. Versions
  48.   of software are current as at time of writing.
  49.  
  50.   In no way do I or the authors of the software in this document offer
  51.   protection against your own actions. If you configure this software,
  52.   even as described in this document and it causes problems on your
  53.   network then you alone must carry the responsibility. I include this
  54.   warning because IPX network design and configuration is not always a
  55.   simple matter and sometimes undesirable interaction with other routers
  56.   and fileservers can result if you do not design or configure your
  57.   network carefully. I also include this warning because I was asked to
  58.   by someone unfortunate enough to have discovered this lesson the hard
  59.   way.
  60.   3.  Related Documentation.
  61.  
  62.   This document presumes you understand how to build a Linux kernel with
  63.   the appropriate networking options selected and that you understand
  64.   how to use the basic network tools such as ifconfig and route.  If you
  65.   do not, then you should read the NET-3-HOWTO <NET-3-HOWTO.html> in
  66.   conjunction with this document as it describes these.
  67.  
  68.   Other Linux HOWTO documents that might be useful are:
  69.  
  70.   The Ethernet-HOWTO <Ethernet-HOWTO.html>, which describes the details
  71.   of configuring an Ethernet device for Linux.
  72.  
  73.   The PPP-HOWTO <PPP-HOWTO.html> as IPX support is available for version
  74.   2.2.0d and later of the Linux PPP implementation.
  75.  
  76.   3.1.  New versions of this document.
  77.  
  78.   If your copy of this document is more than two months old then I
  79.   strongly recommend you obtain a newer version. The networking support
  80.   for Linux is changing very rapidly with new enhancements and features,
  81.   so this document also changes fairly frequently. The latest released
  82.   version of this document can always be retrieved by anonymous ftp
  83.   from:
  84.  
  85.   sunsite.unc.edu
  86.  
  87.        /pub/Linux/docs/HOWTO/IPX-HOWTO
  88.  
  89.   or:
  90.  
  91.        /pub/Linux/docs/HOWTO/other-formats/IPX-HOWTO{-html.tar,ps,dvi}.gz
  92.  
  93.   via the World Wide Web from the Linux Documentation Project Web Server
  94.   <http://sunsite.unc.edu/LDP/linux.html>, at page: IPX-HOWTO
  95.   <http://sunsite.unc.edu/LDP/HOWTO/IPX-HOWTO.html> or directly from me,
  96.   <terry@perf.no.itg.telstra.com.au>. It may also be posted to the
  97.   newsgroups: comp.os.linux.networking, comp.os.linux.answers and
  98.   news.answers from time to time.
  99.  
  100.   3.2.  Feedback.
  101.  
  102.   Please send any comments, updates, or suggestions to me,
  103.   <terry@perf.no.itg.telstra.com.au>. The sooner I get feedback, the
  104.   sooner I can update and correct this document. If you find any
  105.   problems with it, please mail me directly as I now very rarely read
  106.   the newsgroups.
  107.  
  108.   3.3.  Mailing list support.
  109.  
  110.   There is a mailing list established for discussion of the various
  111.   Linux IPX software packages described in this document. You can
  112.   subscribe to it by sending a mail message to `listserv@sh.cvut.cz'
  113.   with `add linware' in the body of the message. To post to the list
  114.   your send your mail to `linware@sh.cvut.cz'.
  115.   The mailing list is archived at www.kin.vslib.cz
  116.   <http://www.kin.vslib.cz/hypermail/linware/>.
  117.  
  118.   4.  Some of the terms used in this document.
  119.  
  120.   You will often see the terms client and server used in this document.
  121.   They are normally fairly specific terms but in this document I have
  122.   generalized their definitions a little so that they mean the
  123.   following:
  124.  
  125.      client
  126.         The machine or program that initiates an action or a connection
  127.         for the purpose of gaining use of some service or data.
  128.  
  129.      server
  130.         The machine or program that accepts incoming connections from
  131.         multiple remote machines and provides a service or data to
  132.         those.
  133.  
  134.   These definitions are not very reliable either, but they provide a
  135.   means of distinguishing the ends of peer to peer systems such as SLIP
  136.   or PPP which truly do not actually have clients and servers.
  137.  
  138.   Other terms you will see are:
  139.  
  140.      Bindery
  141.         The bindery is a specialised database storing network
  142.         configuration information on a Novell fileserver. Netware
  143.         clients may query the bindery to obtain information on available
  144.         services, routing and user information.
  145.  
  146.      Frame Type
  147.         is a term used to describe that actual protocol used to carry
  148.         the IPX (and IP) datagrams across your ethernet style network
  149.         segments. There are four common ones. They are:
  150.  
  151.         Ethernet_II
  152.            This is a refined version of the original DIX ethernet
  153.            standard. Novell has been allocated a formal protocol id and
  154.            this means that both IPX and IP can coexist happily in an
  155.            Ethernet_II environment quite happily. This is commonly used
  156.            in Novell environments and is a good choice.
  157.  
  158.         802.3
  159.            This is an I.E.E.E. protocol defining a Carrier Sense
  160.            Multiple Access with Collision Detection (CSMA/CD) mechanism.
  161.            It was based on the original DIX Ethernet standard, with an
  162.            important modification, the type (protocol id) field was
  163.            converted into a length field instead. It is for this reason
  164.            that IPX really shouldn't be run here. IEEE 802.3 was
  165.            designed to carry IEEE 802.2 frames only but there are
  166.            implementations that use it to carry IPX frames directly and
  167.            remarkably it does work. Avoid it unless you are trying to
  168.            interwork with a network already configured to use it.
  169.  
  170.         802.2
  171.            This is an I.E.E.E. protocol that defines a set of Logical
  172.            Link Control procedures. It provides a simplistic way of
  173.            allowing different protocols to coexist, but is quite limited
  174.            in this respect. Novell uses an unofficial Service Address
  175.            Point (like a protocol id) but since everyone else uses it as
  176.            well, that hasn't yet presented too much of a problem.
  177.  
  178.         SNAP
  179.            SNAP is the Sub Network Access Protocol. This protocol is
  180.            designed ride on top of 802.3 and 802.2. It expands the
  181.            multiprotocol capability of 802.2 and provides some measure
  182.            of compatability with existing Ethernet and Ethernet_II frame
  183.            types.
  184.  
  185.      IPX
  186.         Internet Packet eXchange is a protocol used by the Novell
  187.         corporation to provide internetworking support for their
  188.         NetWare(tm) product.  IPX is similar in functionality to the IP
  189.         protocol used by the tcp/ip community.
  190.  
  191.      IPX network address
  192.         This is a number which uniquely identifies a particular IPX
  193.         network. The usual notation for this address is in hexadecimal.
  194.         An example might look like: 0x23a91002.
  195.  
  196.      IPX Internal network
  197.         This is a virtual IPX network. It is virtual because it does not
  198.         correspond to a physical network. This is used to provide a
  199.         means of uniquely identifying and addressing a particular IPX
  200.         host. This is generally only useful to IPX hosts that exist on
  201.         more than one physical IPX network such as fileservers. The
  202.         address is coded in the same form as for a physical IPX network.
  203.  
  204.      RIP
  205.         Routing Information Protocol is a protocol used to automatically
  206.         propagate network routes in an IPX network. It is functionally
  207.         similar to the RIP used within the tcp/ip community.
  208.  
  209.      NCP
  210.         NetWare Core Protocol is a networked filesystem protocol
  211.         designed by the Novell Corporation for their NetWare(tm)
  212.         product. NCP is functionally similar to the NFS used in the
  213.         tcp/ip community.
  214.  
  215.      SAP
  216.         Service Advertisement Protocol is a protocol designed by the
  217.         Novell Corporation that is used to advertise network services in
  218.         a NetWare(tm) environment.
  219.  
  220.      Hardware address
  221.         This is a number that uniquely identifies a host in a physical
  222.         network at the media access layer. Examples of this are Ethernet
  223.         Addresses. An Ethernet address is generally coded as six
  224.         hexadecimal values separated by colon characters eg.
  225.         00:60:8C:C3:3C:0F
  226.  
  227.      route
  228.         The route is the path that your packets take through the network
  229.         to reach their destination.
  230.  
  231.   5.  The IPX related files in the /proc filesystem.
  232.  
  233.   There are a number of files related to the Linux IPX support that are
  234.   located within the /proc filesystem. They are:
  235.  
  236.      /proc/net/ipx_interface
  237.         This file contains information about the IPX interfaces
  238.         configured on your machine. These may have been configured
  239.         manually by command or automatically detected and configured.
  240.  
  241.      /proc/net/ipx_route
  242.         This file contains a list of the routes that exist in the IPX
  243.         routing table. These routes may have been added manually by
  244.         command or automatically by an IPX routing daemon.
  245.  
  246.      /proc/net/ipx
  247.         This file is a list of the IPX sockets that are currently open
  248.         for use on the machine.
  249.  
  250.   6.  Greg Pages IPX tools.
  251.  
  252.   Greg Page <greg@caldera.com of Caldera Incorporated has written a
  253.   suite of IPX configuration tools and enhanced the Linux IPX kernel
  254.   support.
  255.  
  256.   The kernel enhancements allow linux to be configured as a fully
  257.   featured IPX bridge or router. The enhanced IPX support has already
  258.   been fed back into the mainstream kernel distribution so you will
  259.   probably already have it.
  260.  
  261.   The network configuration tools provide you with the capability to
  262.   configure your network devices to support IPX and allow you to
  263.   configure IPX routing and other facilities under Linux. The Linux IPX
  264.   network tools are available from: sunsite.unc.edu
  265.   <ftp://sunsite.unc.edu/pub/Linux/system/filesystems/ncpfs/ipx.tgz>.
  266.  
  267.   6.1.  The IPX tools in more detail.
  268.  
  269.      ipx_interface
  270.         This command is used to manually add, delete or check ipx
  271.         capability to an existing network device. Normally the network
  272.         device would be an Ethernet device such at eth0. At least one
  273.         IPX interface must be designated the primary interface and the
  274.         -p flag to this command does this. For example to enable
  275.         Ethernet device eth0 for IPX capability as the primary IPX
  276.         interface using the IEEE 802.2 frame type and IPX network
  277.         address 39ab0222 you would use:
  278.  
  279.           # ipx_interface add -p eth0 802.2 0x39ab0222
  280.  
  281.      If you get an error while running this program and you happen to
  282.      not have already configured tcp/ip, then you will find that you
  283.      need to manually start the eth0 interface using the command:
  284.  
  285.           # ifconfig eth0 up
  286.  
  287.      ipx_configure
  288.         This command enables or disables the automatic setting of the
  289.         interface configuration and primary interface settings.
  290.  
  291.         --auto_interface
  292.            allows you to select whether new network devices should be
  293.            automatically configured as IPX devices or not.
  294.  
  295.         --auto_primary
  296.            allows you to select whether the IPX software should
  297.            automatically select a primary interface or not.
  298.  
  299.         A typical example would be to enable both automatic interface
  300.         configuration and automatic primary interface setting with the
  301.         following command:
  302.  
  303.           # ipx_configure --auto_interface=on --auto_primary=on
  304.  
  305.      ipx_internal_net
  306.         This command allows you to configure or deconfigure an internal
  307.         network address. An internal network address is optional, but
  308.         when it is configured it will always be the primary interface.
  309.         To configure an IPX network address of ab000000 on IPX node 1
  310.         you would use:
  311.  
  312.           # ipx_internal_net add 0xab000000 1
  313.  
  314.      ipx_route
  315.         The command allows you to manually modify the IPX routing table.
  316.         For example to add a route to IPX network 39ab0222 via a router
  317.         with node number 00608CC33C0F on IPX network 39ab0108:
  318.  
  319.           # ipx_route add 0x39ab0222 0x39ab0108 0x00608CC33C0F
  320.  
  321.   7.  Configuring your Linux machine as an IPX router.
  322.  
  323.   If you have a number of IPX segments that you wish to internetwork you
  324.   need the services of a router. In the Novell environment there are two
  325.   pieces of information which are necessary to be propagated around the
  326.   network.  They are the network routing information propagated using
  327.   Novell RIP, and the service advertisement information propagated using
  328.   Novell SAP. Any router must support both of these protocols to be
  329.   useful in most situations.
  330.  
  331.   Linux has support for both of these protocols and can be fairly easily
  332.   made to function as a fully Novell compliant router.
  333.  
  334.   The Linux kernel IPX support actually manages the IPX packet
  335.   forwarding across interfaces, but it does this according to the rules
  336.   coded into the IPX routing table. Linux needs a program to implement
  337.   the Novell RIP and SAP to ensure that the IPX routing table is built
  338.   correctly and updated periodically to reflect changes in the network
  339.   status.
  340.  
  341.   Volker Lendecke <lendecke@namu01.gwdg.de> has developed a routing
  342.   daemon that will do this for you.
  343.  
  344.   You can find ipxripd at:
  345.  
  346.   sunsite.unc.edu
  347.   <ftp://sunsite.unc.edu/pub/Linux/system/filesystems/ncpfs/ipxripd-0.7.tgz>
  348.   or at Volkers home site at:
  349.  
  350.   ftp.gwdg.de <ftp://ftp.gwdg.de/pub/linux/misc/ncpfs/ipxripd-0.7.tgz>
  351.  
  352.   Configuring your Linux machine to act as a router is very
  353.   straightforward.  The steps you must take are:
  354.  
  355.   1. Build your kernel with IPX, Ethernet and /proc support.
  356.  
  357.   2. Obtain, compile and install the ipxd daemon program.
  358.  
  359.   3. Boot the new kernel and ensure that each of the Ethernet cards has
  360.      been properly detected and there are no hardware conflicts.
  361.  
  362.   4. Enable the IPX protocol on each of the interfaces using the
  363.      ipx_interface command described above.
  364.  
  365.   5. Start the ipxd daemon program.
  366.  
  367.   Consider the following simple network:
  368.  
  369.    IPX Addr: 0x01000000  802.2
  370.   |--------------------------|
  371.                 |
  372.                 \_________________________
  373.                                           \          Linux Router
  374.    IPX Addr: 0x02000000  802.2             \
  375.   |--------------------------|              \   eth0/-----------\
  376.                 |                            \--====|           |
  377.                 \_________________________          | IPX route |
  378.                                           \     eth1|  Table    |
  379.    IPX Addr: 0x03000000  etherII           \----====|    ^      |
  380.   |--------------------------|                      |    |      |
  381.                 |                               eth2|  IPXd     |
  382.                 \______________________________/====|           |
  383.                                                     |  SAPd     |
  384.    IPX Addr: 0x04000000  etherII                eth3|           |
  385.   |--------------------------|                 /====|           |
  386.                 |                              |    \___________/
  387.                 \______________________________/
  388.  
  389.   The configuration for the above network would look like:
  390.  
  391.        # ipx_interface add eth0 802.2 0x0100000000
  392.        # ipx_interface add eth1 802.2 0x0200000000
  393.        # ipx_interface add eth2 etherii 0x0300000000
  394.        # ipx_interface add eth3 etherii 0x0400000000
  395.        # ipxd
  396.  
  397.   You should then wait a moment or two and check your
  398.   /proc/net/ipx_route file and you should see it populated with the IPX
  399.   routes relevant to your configuration and any learned from any other
  400.   routers in the network.
  401.  
  402.   7.1.  Do I need to configure an internal network ?
  403.  
  404.   Novell has a feature called an internal network, which it uses to
  405.   simplify routing in situations where a host has more than one network
  406.   device connected.  This is useful in the case of a fileserver
  407.   connected to multiple networks as it means that only one route needs
  408.   to be advertised to reach the server regardless of which network you
  409.   are attempting from.
  410.  
  411.   In the case of a configuration where you are not running a fileserver
  412.   and your machine acting only as an IPX router the question is not as
  413.   simple to answer. It has been reported that configuring for IPX/PPP
  414.   works `better' if you also configure an internal network.
  415.  
  416.   In any case it is easy to do, but may require a rebuild of your
  417.   kernel.  When you are working through the kernel make config you must
  418.   answer y when asked Full internal IPX network as illustrated:
  419.  
  420.          ...
  421.          ...
  422.         Full internal IPX network (CONFIG_IPX_INTERN) [N/y/?] y
  423.          ...
  424.          ...
  425.  
  426.   To configure the internal network interface, use the ipx_internal_net
  427.   command described earlier in the IPX tools section. The main
  428.   precaution to take is to ensure that they IPX network address you
  429.   assign is unique on your network and that no other machine or network
  430.   is using it.
  431.  
  432.   8.  Configuring your Linux machine as an NCP client.
  433.  
  434.   If you are a user of a mixed technology network that comprises both IP
  435.   and IPX protocols it is likely that at some time or another you have
  436.   wanted to have your Linux machine access data stored on a Novell
  437.   fileserver on your network. Novell have long offered an NFS server
  438.   package for their fileservers that would allow this, but if you are a
  439.   small site or have only a small number of people interested in doing
  440.   this it is difficult to justify the cost of the commercial package.
  441.  
  442.   Volker Lendecke <lendecke@namu01.gwdg.de> has written a Linux
  443.   filesystem kernel module that supports a subset of the Novell NCP that
  444.   will allow you to mount Novell volumes into your Linux filesystem
  445.   without requiring any additional products for your fileserver.  Volker
  446.   has called the package ncpfs and derived the necessary information
  447.   mainly from the book "Netzwerkprogrammierung in C" by Manfred Hill and
  448.   Ralf Zessin (further details of the book are contained within the
  449.   README file in the ncpfs package).
  450.  
  451.   The software causes Linux to emulate a normal Novell workstation for
  452.   file services. It also includes a small print utility that allows you
  453.   to print to Novell print queues (This is documented in the Print
  454.   Client section later).  The ncpfs package will work with Novell
  455.   fileservers of version 3.x and later, it will not work the Novell 2.x.
  456.   The ncpfs client will also work with close Novell compatible products,
  457.   but unfortunately some products that claim to be compatible aren't
  458.   compatible enough. To use ncpfs with Novell 4.x fileservers, the
  459.   fileserver must be configured to operate in bindery emulation mode,
  460.   because ncpfs does not yet support the NDS.
  461.  
  462.   8.1.  Obtaining ncpfs.
  463.  
  464.   The latest ncpfs package was designed to be built against the version
  465.   1.2.13 kernel or kernels later than 1.3.71 (this includes 2.x.x).  If
  466.   you not using a kernel in either of these categories then you will
  467.   have to upgrade your kernel. The Kernel-HOWTO <Kernel-HOWTO.html>
  468.   describes how to do this in detail.
  469.  
  470.   You can obtain the ncpfs package by anonymous ftp from Volker's home
  471.   site at: ftp.gwdg.de <ftp://ftp.gwdg.de/pub/linux/misc/ncpfs/> or
  472.   sunsite.unc.edu
  473.   <ftp://sunsite.unc.edu/pub/Linux/system/filesystems/ncpfs> or mirror
  474.   sites. The current version at the time of writing was:
  475.   ncpfs-2.0.10.tgz
  476.  
  477.   8.2.  Building ncpfs for kernel 1.2.13.
  478.  
  479.      Build a kernel with Ethernet and IPX support
  480.         The first thing you need to do is ensure that your kernel has
  481.         been built with IPX support enabled.  In the 1.2.13 version
  482.         kernel you need only ensure that you have answered Y to the
  483.         question: 'The IPX protocol' as illustrated:
  484.  
  485.          ...
  486.          ...
  487.         Assume subnets are local (CONFIG_INET_SNARL) [y]
  488.         Disable NAGLE algorithm (normally enabled) (CONFIG_TCP_NAGLE_OFF) [n]
  489.         The IPX protocol (CONFIG_IPX) [n] y
  490.         *
  491.         * SCSI support
  492.          ...
  493.          ...
  494.  
  495.      You will also need to ensure that you include an appropriate driver
  496.      for your Ethernet card. If you do not know how to do this then you
  497.      should read the Ethernet-HOWTO <Ethernet-HOWTO.html>.
  498.  
  499.      You can then proceed to build your kernel. Make sure you remember
  500.      to run lilo to install it when you have finished.
  501.  
  502.      Untar the ncpfs software
  503.  
  504.         # cd /usr/src
  505.         # tar xvfz ncpfs-2.0.10.tgz
  506.         # cd ncpfs
  507.  
  508.      Check the Makefile
  509.         If you intend to use kerneld to autoload the ncpfs kernel module
  510.         then you must uncomment the line in the Makefile that refers to:
  511.         KERNELD. If you are unsure what this means then you should read
  512.         the Kernel-HOWTO <Kernel-HOWTO.html> to familiarise yourself
  513.         with kernel module configuration.
  514.  
  515.      Make the ncpfs software
  516.         The software should compile cleanly with no other configuration
  517.         necessary:
  518.  
  519.         # make
  520.  
  521.      Copy the IPX tools somewhere useful if you don't already have them.
  522.         After the make has completed you should find all of the tools
  523.         you need in the ncpfs/bin directory. You can use:
  524.  
  525.           # make install
  526.  
  527.      to install the tools in Volkers choice of directories. If you are
  528.      running on an ELF based system then you will need to rerun
  529.      `ldconfig -v' to ensure that the shared library is able to be
  530.      found.
  531.  
  532.      Copy the ncpfs.o module somewhere useful if necessary.
  533.         If you are compiling for a 1.2.* kernel then you will find a
  534.         file called ncpfs.o in the ncpfs/bin directory after the make
  535.         has completed. This is the ncpfs kernel module.  You should copy
  536.         this somewhere useful. On my debian system I have copied it to
  537.         the /lib/modules/1.2.13/fs directory and added ncpfs to the
  538.         /etc/modules file so that it will be automatically started at
  539.         boot time. If you are using some other distribution you should
  540.         find where it keeps its modules and copy it there, or just copy
  541.         it to your /etc directory. To load the modules manually you need
  542.         to use the command:
  543.  
  544.         # insmod ncpfs.o
  545.  
  546.   8.3.  Building ncpfs for kernels 1.3.71++/2.0.*.
  547.  
  548.   For the latest version of ncpfs you must use kernel 1.3.71 or newer,
  549.   this includes the 2.0.* kernels.
  550.  
  551.   If you intend using a kernel that is version 1.3.71 or newer then the
  552.   ncpfs kernel code has been included in the standard kernel
  553.   distribution. You need only answer Y to:
  554.  
  555.        Networking options  --->
  556.            ...
  557.            ...
  558.            <*> The IPX protocol
  559.            ...
  560.        Filesystems  --->
  561.            ...
  562.            ...
  563.            <*> NCP filesystem support (to mount NetWare volumes)
  564.            ...
  565.  
  566.   You will still need to follow the instructions for building for
  567.   kernels 1.2.* so that you can build the tools but there will not be a
  568.   module file for you to install.
  569.  
  570.   8.4.  Configuring and using ncpfs.
  571.  
  572.      Configure the IPX network software
  573.         There are two ways of configuring the IPX network software. You
  574.         can manually configure all of your IPX network information or
  575.         you can choose to let the software determine for itself some
  576.         reasonable settings using the command:
  577.  
  578.           # ipx_configure --auto_interface=on --auto_primary=on
  579.  
  580.      This should be reasonable in most circumstances, but if it doesn't
  581.      work for you then read the 'IPX tools' section above to configure
  582.      your software manually.
  583.  
  584.      Test the configuration
  585.         After your IPX network is configured you should be able to use
  586.         the slist command to see a list of all of the Novell fileserver
  587.         on your network:
  588.  
  589.         # slist
  590.  
  591.      If the slist command displays a message like: ncp_connect: Invalid
  592.      argument then your kernel probably does not support IPX. Check that
  593.      you have actually booted off the appropriate kernel.  When you boot
  594.      you should see messages about 'IPX' and 'ncpfs' in the system
  595.      startup messages. If the slist command does not list all of your
  596.      fileservers then you may need to use the manual network configura¡
  597.      tion method.
  598.  
  599.      Mount a Novell(tm) volume.
  600.         If your IPX network software is working ok you should now be
  601.         able to mount a Novell fileserver volume into your Linux
  602.         filesystem. The ncpmount command is used for this purpose and
  603.         requires that you specify at least the following information:
  604.  
  605.         1. The fileserver name
  606.  
  607.         2. The fileserver login id. If it has a password you will also
  608.            need that.
  609.  
  610.         3. The mount point ie. where you want the mount to go. This will
  611.            be an existing directory on your machine.
  612.  
  613.         There is an equivalent ncpumount command to unmount a mounted
  614.         NCP filesystem. The NCP filesystems will be unmounted cleanly if
  615.         you shutdown your machine normally, so you needn't worry about
  616.         ncpumounting your filesystems manually before a halt or
  617.         shutdown.
  618.  
  619.         An example command to mount fileserver ACCT_FS01, with a login
  620.         id of guest with no password, under the /mnt/Accounts directory
  621.         might look like the following:
  622.  
  623.         # ncpmount -S ACCT_FS01 /mnt/Accounts -U guest -n
  624.  
  625.      Note the use of the -n option to indicate that no password is
  626.      required for the login. The same login specifying a password of
  627.      secret would look like:
  628.  
  629.      # ncpmount -S ACCT_FS01 /mnt/Accounts -U guest -P secret
  630.  
  631.      If you don't specify either the -n or the -P options you will be
  632.      prompted for a password.
  633.  
  634.      Check the mount
  635.         If the mount is successful you will find the volumes accessible
  636.         to the userid used for login listed as directories under the
  637.         mount point. You should then also be able to traverse the
  638.         directory structure to find other files. Because NCP does not
  639.         provide uid or gid ownership of files, all of the files will
  640.         have the permission and ownership assigned to the mount point
  641.         directory, keep this in mind when sharing mounts between Linux
  642.         users.
  643.  
  644.      Configure mounts to be automatically performed.
  645.         If you have some need to permanently have an ncp mount then you
  646.         will want to configure the commands above into your rc files so
  647.         that they occur automatically at boot time. If your distribution
  648.         doesn't already provide some way of configuring IPX like debian
  649.         then I recommend you place them in your /etc/rc.local file if
  650.         you have one. You might use something like:
  651.  
  652.           #
  653.           # Start the ncp filesystem
  654.           /sbin/insmod /lib/modules/1.2.13/fs/ncpfs.o
  655.  
  656.           # configure the IPX network
  657.           ipx_configure --auto_interface=on --auto_primary=on
  658.  
  659.           # guest login to the Accounting fileserver
  660.           ncpmount -S ACCT_FS01 /mnt/Accounts -U guest -n
  661.  
  662.           #
  663.  
  664.      There is another means of configuring NCP mounts and that is by
  665.      building a $HOME/.nwclient file. This file contains details of tem¡
  666.      porary or user specific NCP mounts that would be performed regu¡
  667.      larly. It allows you to store the details of mounts so that you can
  668.      recreate them without having to specify all of the detail each
  669.      time.
  670.  
  671.      Its format is quite straightforward:
  672.  
  673.      # The first entry is the 'preferred server' entry and is
  674.      # used whenever you do not specify a server explicitly.
  675.      #
  676.      # User TERRY login to DOCS_FS01 fileserver with password 'password'
  677.      DOCS_FS01/TERRY password
  678.      #
  679.      # Guest login to the ACCT_FS01 fileserver with no password.
  680.      ACCT_FS01/GUEST -
  681.  
  682.      To activate these mounts you could use:
  683.  
  684.           $ ncpmount /home/terry/docs
  685.  
  686.      to mount: DOCS_FS01 with a login of TERRY under the
  687.      /home/terry/docs directory. Note that this entry was chosen because
  688.      no fileserver was specified in the mount command. If the following
  689.      command were used:
  690.  
  691.           $ ncpmount -S ACCT_FS01 /home/terry/docs
  692.  
  693.      then a GUEST login to ACCT_FS01 would be mounted there instead.
  694.  
  695.      Note: for this mechanism to work the permissions of the
  696.      $HOME/.nwclient file must be 0600 so you would need to use the
  697.      command:
  698.  
  699.           $ chmod 0600 $HOME/.nwclient
  700.  
  701.      If non-root users are to be allowed to use this mechanism then the
  702.      ncpmount command must be Set Userid Root, so you would need to give
  703.      it permissions:
  704.  
  705.           # chmod 4755 ncpmount
  706.  
  707.      Try out the nsend utility
  708.         a utility to send messages to Novell users is also included in
  709.         the package, it is called nsend and is used as follows:
  710.  
  711.         # nsend rod hello there
  712.  
  713.      would send the message "hello there" to a logged in user "rod" on
  714.      your "primary" fileserver (the first one appearing in your
  715.      .nwclient file. You can specify another fileserver with the same
  716.      syntax as for the ncpmount command.
  717.  
  718.   9.  Configuring your Linux machine as an NCP server.
  719.  
  720.   There are two packages available that allow Linux to provide the
  721.   functions of a Novell Fileserver. They both allow you to share files
  722.   on your linux machine with users using Novell NetWare client software.
  723.   Users can attach and map filesystems to appear as local drives on
  724.   their machines just as they would to a real Novell fileserver. You may
  725.   want to try both to see which best serves your intended purpose.
  726.  
  727.   9.1.  The mars_nwe package.
  728.  
  729.   Martin Stover <mstover@freeway.de> developed mars_nwe to enable linux
  730.   to provide both file and print services for NetWare clients.
  731.  
  732.   In case you are wondering about the name: mars_nwe is Martin Stovers
  733.   Netware Emulator.
  734.  
  735.   9.1.1.  Capability of mars_nwe.
  736.  
  737.   mars_nwe implements a subset of the full Novell NCP for file services,
  738.   disk based bindery and also print services. It is likely to contain
  739.   bugs but there are many people using it now and the number of bugs is
  740.   steadily decreasing as new versions are released.
  741.  
  742.   9.1.2.  Obtaining mars_nwe.
  743.  
  744.   You can obtain mars_nwe from ftp.gwdg.de
  745.   <ftp://ftp.gwdg.de/pub/linux/misc/ncpfs/> or from
  746.   <ftp://sunsite.unc.edu/pub/Linux/system/filesystems/ncpfs/>.
  747.  
  748.   The version current at the time of writing was: mars_nwe-0.98.pl8.tgz.
  749.  
  750.   9.1.3.  Building the mars_nwe package.
  751.  
  752.      Build a kernel with Ethernet and IPX Support
  753.         In the 1.2.13 version kernel you need only ensure that you have
  754.         answered Y to the question: 'The IPX protocol' and N to the
  755.         question: `Full internal IPX network' as illustrated:
  756.  
  757.          ...
  758.          ...
  759.         The IPX protocol (CONFIG_IPX) [n] y
  760.          ...
  761.          ...
  762.         Full internal IPX network (CONFIG_IPX_INTERN) [N/y/?] n
  763.          ...
  764.          ...
  765.  
  766.      In newer kernels a similar process is adopted but the actual text
  767.      of the prompt may have changed slightly.
  768.  
  769.      You will also need to ensure that you include an appropriate driver
  770.      for your Ethernet card. If you do not know how to do this then you
  771.      should read the Ethernet-HOWTO <Ethernet-HOWTO.html>.
  772.  
  773.      You can then proceed to build your kernel. Make sure you remember
  774.      to run lilo to install it when you have finished.
  775.  
  776.      Untar the mars_nwe package.
  777.  
  778.           # cd /usr/src
  779.           # tar xvfz mars_nwe-0.98.pl3.tgz
  780.  
  781.      Make mars_nwe.
  782.         To make the package is very simple.  The first step is to simply
  783.         run make, this will create a config.h file for you. Next you
  784.         should look at and edit the config.h file if necessary. It
  785.         allows you to configure items such as the installation
  786.         directories that will be used and the maximum number of sessions
  787.         and volumes that the server will support. The really important
  788.         entries to look at are:
  789.  
  790.         FILENAME_NW_INI       the location of the initialisation file
  791.         PATHNAME_PROGS        where the executable support programs will be found.
  792.         PATHNAME_BINDERY      where the 'bindery' files will go.
  793.         PATHNAME_PIDFILES     the directory for the 'pid' files to be written.
  794.         MAX_CONNECTIONS       the maximum number of simultaneous connections allowed.
  795.         MAX_NW_VOLS           the maximum number of volumes mars_nwe will support.
  796.         MAX_FILE_HANDLES_CONN the maximum number of open files per connection.
  797.         WITH_NAME_SPACE_CALLS if you want to support ncpfs clients.
  798.         INTERNAL_RIP_SAP      whether you want mars_nwe to provide rip/sap routing.
  799.         SHADOW_PWD            whether you use shadow passwords or not.
  800.  
  801.      The defaults will probably be ok but you should check anyway.
  802.  
  803.      When this is done:
  804.  
  805.           # make
  806.           # make install
  807.  
  808.      will build the servers and install them in the appropriate
  809.      directory. The installation script also installs the configuration
  810.      file /etc/nwserv.conf.
  811.  
  812.      Configure the server.
  813.         Configuration is fairly simple. You need to edit the
  814.         /etc/nwserv.conf file. The format of this file may at first look
  815.         a little cryptic, but it is fairly straightforward. The file
  816.         contains a number of single line configuration items. Each line
  817.         is whitespace delimited and begins with a number that indicates
  818.         the contents of the line. All characters following a '#'
  819.         character are considered a comment and ignored. Martin supplies
  820.         an example configuration file in the package, but I'll present
  821.         what I consider to be a simplified example to offer an
  822.         alternative for you.
  823.  
  824.      # VOLUMES (max. 5)
  825.      # Only the SYS volume is compulsory. The directory containing the SYS
  826.      # volume must contain the directories: LOGIN, PUBLIC, SYSTEM, MAIL.
  827.      # The 'i' option ignores case.
  828.      # The 'k' option converts all filenames in NCP requests to lowercase.
  829.      # The 'm' option marks the volume as removable (useful for cdroms etc.)
  830.      # The 'r' option set the volume to read-only.
  831.      # The 'o' option indicates the volume is a single mounted filesystem.
  832.      # The 'P' option allows commands to be used as files.
  833.      # The 'O' option allows use of the OS/2 namespace
  834.      # The 'N' option allows use of the NFS namespace
  835.      # The default is upper case.
  836.      # Syntax:
  837.      #    1 <Volumename> <Volumepath>   <Options>
  838.  
  839.      1   SYS         /home/netware/SYS/               # SYS
  840.      1   DATA        /home/netware/DATA/      k       # DATA
  841.      1   CDROM       /cdrom                   kmr     # CDROM
  842.  
  843.      # SERVER NAME
  844.      # If not set then the linux hostname will be converted to upper case
  845.      # and used. This is optional, the hostname will be used if this is not
  846.      # configured.
  847.      # Syntax:
  848.      #    2 <Servername>
  849.  
  850.      2   LINUX_FS01
  851.  
  852.      # INTERNAL NETWORK ADDRESS
  853.      # The Internal IPX Network Address is a feature that simplifies IPX routing
  854.      # for multihomed hosts (hosts that have ports on more than one IPX network).
  855.      # Syntax:
  856.      #    3 <Internal Network Address> [<Node Number>]
  857.      # or:
  858.      #    3 auto
  859.      #
  860.      # If you use 'auto' then your host IP address will be used. NOTE: this may
  861.      # be dangerous, please be sure you pick a number unique to your network.
  862.      # Addresses are 4byte hexadecimal (the leading 0x is required).
  863.  
  864.      3   0x49a01010  1
  865.  
  866.      # NETWORK DEVICE(S)
  867.      # This entry configures your IPX network. If you already have your
  868.      # IPX network configured then you do not need this. This is the same as
  869.      # using ipx_configure/ipx_interface before you start the server.
  870.      # Syntax:
  871.      #    4 <IPX Network Number> <device_name> <frametype> [<ticks>]
  872.      #                         Frame types: ethernet_ii, 802.2, 802.3, SNAP
  873.  
  874.      4  0x39a01010  eth0  802.3  1
  875.  
  876.      # SAVE IPX ROUTES AFTER SERVER IS DOWNED
  877.      # Syntax:
  878.      #    5 <flag>
  879.      #       0 = don't save routes, 1 = do save routes
  880.  
  881.      5 0
  882.  
  883.      # NETWARE VERSION
  884.      # Syntax:
  885.      #    6 <version>
  886.      #      0 = 2.15, 1 = 3.11
  887.  
  888.      6 1
  889.      # PASSWORD HANDLING
  890.      # Real Novell DOS clients support a feature which encypts your
  891.      # password when changing it. You can select whether you want your
  892.      # mars server to support this feature or not.
  893.      # Syntax
  894.      #    7 <flag>
  895.      #    <flag> is:
  896.      #        0 to force password encryption. (Clients can't change password)
  897.      #        1 force password encryption, allow unencrypted password change.
  898.      #        7 allow non-encrypted password but no empty passwords.
  899.      #        8 allow non-encrypted password including empty passwords.
  900.      #        9 completely unencrypted passwords (doesn't work with OS/2)
  901.  
  902.      7 1
  903.  
  904.      # MINIMAL GID UID rights
  905.      # permissions used for attachments with no login. These permissions
  906.      # will be used for the files in your primary server attachment.
  907.      # Syntax:
  908.      #    10 <gid>
  909.      #    11 <uid>
  910.      #    <gid> <uid> are from /etc/passwd, /etc/groups
  911.  
  912.      10  200
  913.      11  201
  914.  
  915.      # SUPERVISOR password
  916.      # May be removed after the server is started once. The server will
  917.      # encrypt this information into the bindery file after it is run.
  918.      # You should avoid using the 'root' user and instead use another
  919.      # account to administer the mars fileserver.
  920.      #
  921.      # This entry is read and encrypted into the server bindery files, so
  922.      # it only needs to exist the first time you start the server to ensure
  923.      # that the password isn't stolen.
  924.      #
  925.      # Syntax:
  926.      #    12 <Supervisor-Login> <Unix username> [<password>]
  927.  
  928.      12  SUPERVISOR  terry  secret
  929.  
  930.      # USER ACCOUNTS
  931.      # This associates NetWare logins with unix accounts. Password are
  932.      # optional.
  933.      # Syntax:
  934.           13 <User Login> <Unix Username> [<password>]
  935.  
  936.      13  MARTIN martin
  937.      13  TERRY  terry
  938.  
  939.      # LAZY SYSTEM ADMIN CONFIGURATION
  940.      # If you have a large numbers of users and could not be bothered using
  941.      # type 13 individual user mappings, you can automatically map mars_nwe
  942.      # logins to linux user names. BUT, there is currently no means of making
  943.      # use of the linux login password so all users configured this way are
  944.      # will use the single password supplied here. My recommendation is not
  945.      # to do this unless security is absolutely no concern to you.
  946.      # Syntax:
  947.      #    15 <flag> <common-password>
  948.      #    <flag> is: 0  - don't automatically map users.
  949.      #               1  - do automatically map users not configured above.
  950.      #               99 - automatically map every user in this way.
  951.  
  952.      15  0  duzzenmatta
  953.  
  954.      # SANITY CHECKING
  955.      # mars_nwe will automatically ensure that certain directories exist if
  956.      # you set this flag.
  957.      # Syntax:
  958.      #    16 <flag>
  959.      #    <flag> is 0 for no, don't, or 1 for yes, do.
  960.  
  961.      16  0
  962.  
  963.      # PRINT QUEUES
  964.      # This associates NetWare printers with unix printers. The queue
  965.      # directories must be created manually before printing is attempted.
  966.      # The queue directories are NOT lpd queues.
  967.      # Syntax:
  968.      #    21 <queue_name> <queue_directory> <unix_print_cmd>
  969.  
  970.      21  EPSON  SYS:/PRINT/EPSON lpr -h
  971.      21  LASER  SYS:/PRINT/LASER lpr -Plaser
  972.  
  973.      # DEBUG FLAGS
  974.      # These are not normally needed, but may be useful if are you debugging
  975.      # a problem.
  976.      # Syntax:
  977.      #    <debug_item> <debug_flag>
  978.      #
  979.      #    100 = IPX KERNEL
  980.      #    101 = NWSERV
  981.      #    102 = NCPSERV
  982.      #    103 = NWCONN
  983.      #    104 = start NWCLIENT
  984.      #    105 = NWBIND
  985.      #    106 = NWROUTED
  986.      #                 0 = disable debug, 1 = enable debug
  987.  
  988.      100 0
  989.      101 0
  990.      102 0
  991.      103 0
  992.      104 0
  993.      105 0
  994.      106 0
  995.  
  996.      # RUN NWSERV IN BACKGROUND AND USE LOGFILE
  997.      # Syntax:
  998.      #    200 <flag>
  999.      #        0 = run NWSERV in foreground and don't use logfile
  1000.      #        1 = run NWSERV in background and use logfile
  1001.  
  1002.      200  1
  1003.  
  1004.      # LOGFILE NAME
  1005.      # Syntax:
  1006.      #    201 <logfile>
  1007.  
  1008.      201  /tmp/nw.log
  1009.  
  1010.      # APPEND LOG OR OVERWRITE
  1011.      # Syntax:
  1012.      #    202 <flag>
  1013.      #        0 = append to existing logfile
  1014.      #        1 = overwrite existing logfile
  1015.  
  1016.      202  1
  1017.  
  1018.      # SERVER DOWN TIME
  1019.      # This item sets the time after a SERVER DOWN is issued that the
  1020.      # server really goes down.
  1021.      # Syntax:
  1022.      #    210 <time>
  1023.      #        in seconds. (defaults 10)
  1024.  
  1025.      210  10
  1026.  
  1027.      # ROUTING BROADCAST INTERVAL
  1028.      # The time is seconds between server broadcasts
  1029.      # Syntax:
  1030.      #    211 <time>
  1031.      #        in seconds. (defaults 60)
  1032.  
  1033.      211  60
  1034.  
  1035.      # ROUTING LOGGING INTERVAL
  1036.      # Set how many broadcasts take place before logging of routing
  1037.      # information occurs.
  1038.      # Syntax:
  1039.      #    300  <number>
  1040.  
  1041.      300  5
  1042.  
  1043.      # ROUTING LOGFILE
  1044.      # Set the name of the routing logfile
  1045.      # Syntax:
  1046.      #    301 <filename>
  1047.  
  1048.      301  /tmp/nw.routes
  1049.  
  1050.      # ROUTING APPEND/OVERWRITE
  1051.      # Set whether you want to append to an existing log file or
  1052.      # overwrite it.
  1053.      # Syntax:
  1054.      #    302 <flag>
  1055.      #        <flag> is 0 for append, 1 for create/overwrite
  1056.  
  1057.      302  1
  1058.  
  1059.      # WATCHDOG TIMING
  1060.      # Set the timing for watchdog messages that ensure the network is
  1061.      # still alive.
  1062.      # Syntax:
  1063.      #    310 <value>
  1064.      #        <value> =   0 - always send watchdogs
  1065.      #                  < 0 - (-ve) for disable watchdogs
  1066.      #                  > 0 - send watchdogs when network traffic
  1067.      #                        drops below 'n' ticks
  1068.  
  1069.      310  7
  1070.  
  1071.      # STATION FILE
  1072.      # Set the filename for the stations file which determine which
  1073.      # machines this fileserver will act as the primary fileserver for.
  1074.      # The syntax of this file is described in the 'examples' directory
  1075.      # of the source code.
  1076.      # Syntax:
  1077.      #    400 <filename>
  1078.  
  1079.      400  /etc/nwserv.stations
  1080.  
  1081.      # GET NEAREST FILESERVER HANDLING
  1082.      # Set how SAP Get Nearest Fileserver Requests are handled.
  1083.      # Syntax:
  1084.      #    401 <flag>
  1085.      #        <flag> is: 0 - disable 'Get Nearest Fileserver' requests.
  1086.      #                   1 - The 'stations' file lists stations to be excluded.
  1087.      #                   2 - The 'stations' file lists stations to be included.
  1088.  
  1089.      401  2
  1090.  
  1091.      Start the server
  1092.         If you've configured the server to expect external programs to
  1093.         configure your network and/or provide the routing function then
  1094.         you should start those before starting the server. Presuming you
  1095.         have configured the server so that itwill configure your
  1096.         interfaces for you and provide the routing services you need
  1097.         only issue the command:
  1098.  
  1099.           # nwserv
  1100.  
  1101.      Test the server
  1102.         To test the server you should first try to attach and login from
  1103.         a NetWare client on your network. You then set a CAPTURE from
  1104.         the client and attempt a print. If both of these are successful
  1105.         then the server is working.
  1106.  
  1107.   9.2.  The lwared package.
  1108.  
  1109.   Ales Dryak <A.Dryak@sh.cvut.cz> developed lwared to allow Linux to
  1110.   function as an NCP based fileserver.
  1111.  
  1112.   Ales has called the package lwared, an abbreviation for LinWare
  1113.   Daemon.
  1114.  
  1115.   9.2.1.  Capability of lwared.
  1116.  
  1117.   The lwared server is capable of providing a subset of the full
  1118.   function of the Novell NCP. It incorporates messaging but it does not
  1119.   provide any printing facilities at all. It does not currently work
  1120.   very well with either Windows95 or Windows NT clients. The lwared
  1121.   server relies on external programs to build and update the IPX routing
  1122.   and SAP tables.  Misbehaving clients can cause the server to crash.
  1123.   Importantly, filename translation facilities have not been included.
  1124.  
  1125.   The server does work for NETX and VLM NetWare shells.
  1126.  
  1127.   9.2.2.  Obtaining lwared
  1128.  
  1129.   The lwared package can be built for any kernel newer than 1.2.0, I
  1130.   recommend you use version 1.2.13 as no kernel patches are required if
  1131.   you do. Some of the IPX functionality has changed with the version
  1132.   1.3.* kernels and this means that patches are now required to make it
  1133.   work properly. Appropriate patches are included for the new kernels,
  1134.   so if you must use an alpha kernel you should still be able to get
  1135.   lwared to work properly for you.
  1136.  
  1137.   You can obtain the lwared package by anonymous ftp from:
  1138.   klokan.sh.cvut.cz <ftp://klokan.sh.cvut.cz/pub/linux/linware/>
  1139.  
  1140.   or from:
  1141.  
  1142.   sunsite.unc.edu
  1143.   <ftp://sunsite.unc.edu/pub/Linux/system/network/daemons> or mirror
  1144.   sites. The current version at the time of writing was:
  1145.   lwared-0.95.tar.gz
  1146.  
  1147.   9.2.3.  Building lwared
  1148.  
  1149.      Untar the lwaredpackage
  1150.         Something like:
  1151.  
  1152.         # cd /usr/src
  1153.         # tar xvpfz lwared-0.95.tar.gz
  1154.  
  1155.      Build a kernel with Ethernet and IPX support
  1156.         If you are using an alpha 1.3.* kernel then you should try and
  1157.         use kernel version 1.3.17 or newer because the supplied patches
  1158.         were built against it. 1.3.* kernels older than 1.3.17 will
  1159.         require hand patching to install. (some information on how to do
  1160.         this is included in the INSTALL file in the package.). To
  1161.         install the patches against a 1.3.17 kernel or newer you should
  1162.         try:
  1163.  
  1164.         # make patch
  1165.  
  1166.      After applying the patches if necessary, the next thing you need to
  1167.      do is ensure that your kernel has been built with IPX support
  1168.      enabled. In the 1.2.13 version kernel you need only ensure that you
  1169.      have answered Y to the question: 'The IPX protocol' as illustrated:
  1170.  
  1171.       ...
  1172.       ...
  1173.      Assume subnets are local (CONFIG_INET_SNARL) [y]
  1174.      Disable NAGLE algorithm (normally enabled) (CONFIG_TCP_NAGLE_OFF) [n]
  1175.      The IPX protocol (CONFIG_IPX) [n] y
  1176.      *
  1177.      * SCSI support
  1178.       ...
  1179.       ...
  1180.  
  1181.      In newer kernels a similar process is adopted by the actual text of
  1182.      the prompt may have changed slightly.
  1183.  
  1184.      You will also need to ensure that you include an appropriate driver
  1185.      for your Ethernet card. If you do not know how to do this then you
  1186.      should read the Ethernet-HOWTO <Ethernet-HOWTO.html>.
  1187.  
  1188.      You can then proceed to build your kernel. Make sure you remember
  1189.      to run lilo to install it when you have finished.
  1190.  
  1191.      Compile and install lwared.
  1192.         To compile lwared you should first check, edit if necessary, the
  1193.         server/config.h file. This file contains various settings that
  1194.         will govern the way your server will behave when it is running.
  1195.         The defaults are reasonable, though you might want to check that
  1196.         the directories specified for the log files and configuration
  1197.         files suit your system.
  1198.  
  1199.         # make depend
  1200.         # make
  1201.         # make install
  1202.  
  1203.      I found that the 'make depend' complained about not finding the
  1204.      float.h file on my system but appeared to work anyway.  I also
  1205.      found that when I tried compiling with gcc 2.6.3 I found I had to
  1206.      change the line:
  1207.  
  1208.      #include <net/route.h>
  1209.  
  1210.      to
  1211.  
  1212.      #include <net/if_route.h>
  1213.  
  1214.      in lib/ipxkern.c as this file changed name sometime.
  1215.  
  1216.      The 'make install' will attempt to install the server and routing
  1217.      daemon programs into your /usr/sbin directory, the lwpasswd program
  1218.      into your /usr/bin directory, the IPX utility programs will be
  1219.      installed into your /sbin directory and last but not least the
  1220.      manual pages will go into the /usr/man directory structure. If any
  1221.      of these locations are not suitable for your system then you should
  1222.      edit the relevant Makefile and change the target directories to
  1223.      suit.
  1224.  
  1225.   9.2.4.  Configuring and using lwared
  1226.  
  1227.   Now the fun bit!
  1228.  
  1229.      Configuring the IPX network
  1230.         The first thing you must do is configure your Ethernet
  1231.         interfaces to support the IPX networks your server will support.
  1232.         To do this you will need to know the IPX network addresses for
  1233.         each of your LAN segments, which Ethernet device (eth0, eth1
  1234.         etc.) is on which segment, what frame type (802.3, EtherII etc.)
  1235.         each LAN segment uses and what Internal Network address your
  1236.         server should use (this is really needed if your server will
  1237.         service more than one LAN segment).  A configuration for a
  1238.         server that is on two dis-similar segments with IPX network
  1239.         addresses 23a91300 and 23a91301 and internal network address
  1240.         bdefaced might look like:
  1241.  
  1242.         # ipx_internal_net add BDEFACED 1
  1243.         # ipx_interface add eth0 802.3 23a91300
  1244.         # ipx_interface add eth1 etherii 23a91301
  1245.  
  1246.      Start the routing daemons
  1247.         The kernel software itself actually does the IPX packet
  1248.         forwarding as it does for IP, but the kernel requires additional
  1249.         programs to manage the routing table updates. In the case of IPX
  1250.         two daemons are needed and both are supplied with lwared:
  1251.         ipxripd manages the IPX routing information and ipxsapd manages
  1252.         the SAP information.  To start the daemons you need only specify
  1253.         the location of where they should write their log messages:
  1254.         # ipxripd /var/adm/ipxrip
  1255.         # ipxsapd /var/adm/ipxsap
  1256.  
  1257.      Configure the lwared server
  1258.         There are two files that you must manually configure to allow
  1259.         user login to your lwared server.  They are:
  1260.  
  1261.         /etc/lwpasswd
  1262.            This is where LinWare user account information is kept. The
  1263.            lwpasswd program is to keep it up to date.  In its simplest
  1264.            form the /etc/lwpasswd file looks like:
  1265.  
  1266.            ales:
  1267.            terryd:
  1268.            guest:
  1269.  
  1270.         Its format is a simple list of login id followed by a ':' char¡
  1271.         acter and then the encrypted version of the login passwd. A cou¡
  1272.         ple of important caveats here: No encrypted password means no
  1273.         password, LinWare users must have Linux accounts, that is any
  1274.         user you place in /etc/lwpasswd must also appear in /etc/passwd
  1275.         and root is the only account that can change the password of
  1276.         another LinWare user. If you are logged in as root you can
  1277.         change the password of a LinWare user as this transcript demon¡
  1278.         strates:
  1279.  
  1280.         # lwpasswd rodg
  1281.         Changing password for RODG
  1282.         Enter new password:
  1283.         Re-type new password:
  1284.         Password changed.
  1285.  
  1286.         /etc/lwvtab
  1287.            This is the LinWare volume tables and it stores information
  1288.            about what directories should be made available to LinWare
  1289.            users (this file is similar in nature to the NFS /etc/exports
  1290.            file). A simple example of its format is as follows:
  1291.  
  1292.            SYS             /lwfs/sys
  1293.            DATA            /lwfs/data
  1294.            HOME            /home
  1295.  
  1296.         The format is simple: Volume name followed by whitespace fol¡
  1297.         lowed by Linux directory to export. You must have at least an
  1298.         entry for the SYS volume for the server to start. If you intend
  1299.         your DOS based users to be able use your LinWare server as their
  1300.         primary server then you must install a standard SYS volume
  1301.         directory structure underneath the directory you export as your
  1302.         SYS volume. Since these files are proprietary and copyright to
  1303.         the Novell corporation you should have a license for these. If
  1304.         you users will be using a Novell fileserver as their primary
  1305.         server then this will not be necessary.
  1306.  
  1307.      Start the lwared server.
  1308.         tada!
  1309.  
  1310.         # lwared
  1311.  
  1312.      It is almost an anticlimax isn't it ? Ok so you've got a question,
  1313.      right?  What is the fileserver name that is being advertised ? If
  1314.      you started the server as shown then the LinWare server name being
  1315.      advertised will be based on what is returned by the Linux hostname.
  1316.      If you'd like it to be something else then you can give the server
  1317.      the name when you start it, for example:
  1318.  
  1319.      # lwared -nlinux00
  1320.  
  1321.      would start the server with the name linux00.
  1322.  
  1323.      Test the lwared server.
  1324.         The very first thing to test is that your LinWare server appears
  1325.         in an slist from a DOS client on your network. The slist program
  1326.         is stored on the SYS volume of a Novell fileserver so you must
  1327.         do this from a machine that is already logged in somewhere. If
  1328.         this is not successful then check that ipxsapd and lwared are
  1329.         both running. If the slist is successful then you should try
  1330.         attaching to the server and mapping a volume:
  1331.  
  1332.         C:> attach linux00/ales
  1333.          ...
  1334.          ...
  1335.         C:> map l:=linux00/data:
  1336.         C:> l:
  1337.  
  1338.      You should then be able to treat the new map just like any other
  1339.      map. The file permissions you will have will be based on those
  1340.      allowed to the linux account that parallels your LinWare login.
  1341.  
  1342.   10.  Configuring your Linux machine as a Novell Print Client.
  1343.  
  1344.   The ncpfs package includes two small programs that allow you to handle
  1345.   printing from you Linux machine to a printer attached to a Novell
  1346.   print server.  The nprint command allows you to print to a file to a
  1347.   NetWare print queue. The pqlist command allows you the list the
  1348.   available print queues on a NetWare server.
  1349.  
  1350.   To obtain and install these commands just follow the instructions
  1351.   relating to the NCP client described earlier.
  1352.  
  1353.   Both commands require that you supply username and password so you
  1354.   might normally consider building some shell scripts to make the task
  1355.   of printing easier.
  1356.  
  1357.   An example might look like:
  1358.  
  1359.        # pqlist -S ACCT_FS01 -U guest -n
  1360.        # nprint -S ACCT_FS01 -q LASER -U guest -n filename.txt
  1361.  
  1362.   The login syntax is similar to the ncpmount command. The examples
  1363.   above assume that fileserver ACCT_FS01 has a guest account with no
  1364.   password, that a print queue called LASER exists and that guest is
  1365.   allowed to print to it.
  1366.   11.  Configuring your Linux machine as a Novell Print Server.
  1367.  
  1368.   A program to allow your Linux machine to act as a print server on a
  1369.   Netware network is included in the ncpfs package. For instructions on
  1370.   how to obtain and build, it follow the directions in the `Netware
  1371.   client' section above.
  1372.  
  1373.   11.1.  Prerequisites
  1374.  
  1375.   Configuration is quite straightforward but relies on you already
  1376.   having your printer configuration completed and working under Linux.
  1377.   This is covered in the Printing-HOWTO <Printing-HOWTO.html> in some
  1378.   depth.
  1379.  
  1380.   11.2.  Configuration
  1381.  
  1382.   When you have a working printer configuration, and you have built and
  1383.   installed the pserver utility then you need to add commands to start
  1384.   it into your rc files.
  1385.  
  1386.   Exactly what command will use will depend on depend on exactly how you
  1387.   want it to operate, but in its simplest form something like the
  1388.   following will work:
  1389.  
  1390.        # pserver -S ACCT_01 -U LASER -P secret -q LASERJET
  1391.  
  1392.   This example asks the pserver utility to login in to the ACCT_01
  1393.   fileserver with username LASER and password secret and to take jobs
  1394.   from the LASERJET print queue. When an incoming print job is received
  1395.   it will use the default print command of lpr to feed the print job to
  1396.   the Linux print daemon.
  1397.  
  1398.   You could if you wished use any Linux command to accept and print the
  1399.   print job. The -c argument allows you to specify the exact print
  1400.   command.  For example:
  1401.  
  1402.        # pserver -S ACCT_01 -U LASER -P secret -q LASERJET -c "lpr -Plaserjet"
  1403.  
  1404.   would do exactly the same as the previous example except it would send
  1405.   the job to the laserjet printcap configuration instead of the default
  1406.   one.
  1407.  
  1408.   12.  An overview of the ncpfs user and adminstration commands
  1409.  
  1410.   Recent versions of Volker's ncpfs package include a range of user and
  1411.   administration commands that you might want to use. The tools are
  1412.   built and installed as part of the ncpfs installation process, so if
  1413.   you haven't already, follow the instructions supplied in the Novell
  1414.   Client section above to build and install them.
  1415.  
  1416.   Detailed information is available in the supplied man pages but a
  1417.   brief summary of the commands is as follows;
  1418.  
  1419.   12.1.  User commands.
  1420.  
  1421.      ncopy
  1422.         Network Copy - allows efficient file copies to be performed by
  1423.         using a Netware function rather than a copy across the network.
  1424.  
  1425.      nprint
  1426.         Network Print - allows you to print a file to a Netware print
  1427.         queue on a Netware server.
  1428.  
  1429.      nsend
  1430.         Network Send - allows you to send messages to other users on a
  1431.         Netware server.
  1432.  
  1433.      nwbols
  1434.         List Bindery Objects - allows you to list the bindery contents
  1435.         of a Netware server.
  1436.  
  1437.      nwboprops
  1438.         List Properties of a Bindery Object - allows you to the
  1439.         properties of a Netware bindery object.
  1440.  
  1441.      nwbpset
  1442.         Set Bindery Property - allows you to set the properties of a
  1443.         Netware bindery object.
  1444.  
  1445.      nwbpvalues
  1446.         Print Netware Bindery Objects Property Contents - allows you to
  1447.         print the contents of a Netware bindery property.
  1448.  
  1449.      nwfsinfo
  1450.         Fileserver Information - prints some summary information about a
  1451.         Netware server.
  1452.  
  1453.      nwpasswd
  1454.         Netware Password - allows you to change a Netware users
  1455.         password.
  1456.  
  1457.      nwrights
  1458.         Netware Rights - displays the rights associated with a
  1459.         particular file or directory.
  1460.  
  1461.      nwuserlist
  1462.         Userlist - lists the users currently logged into a Netware
  1463.         fileserver.
  1464.  
  1465.      pqlist
  1466.         Print Queue List - displays the contents of a Netware print
  1467.         queue.
  1468.  
  1469.      slist
  1470.         Server List - displays a list of know Netware fileserver.
  1471.  
  1472.   12.2.  Administration tools.
  1473.  
  1474.      nwbocreate
  1475.         Create a Bindery Object - allows you to create a Netware bindery
  1476.         object.
  1477.  
  1478.      nwborm
  1479.         Remove Bindery Object - allows you to delete a Netware bindery
  1480.         object.
  1481.  
  1482.      nwbpadd
  1483.         Add Bindery Property - allows you to set the value of an
  1484.         existing property of a Netware bindery object.
  1485.  
  1486.      nwbpcreate
  1487.         Create Bindery Property - allows you to create a new property
  1488.         for an existing Netware bindery object.
  1489.  
  1490.      nwbprm
  1491.         Remove Bindery Property - allows you to remove a property from a
  1492.         Netware bindery object.
  1493.  
  1494.      nwgrant
  1495.         Grant Trustee Rights - allows you to assign trustee rights to a
  1496.         directory on a Netware fileserver.
  1497.  
  1498.      nwrevoke
  1499.         Revoke Trustee Rights - allows you to remove trustee rights from
  1500.         a directory on a Netware fileserver.
  1501.  
  1502.   13.  Configuring PPP for IPX support.
  1503.  
  1504.   New versions of the pppd PPP daemon for Linux have support that allows
  1505.   you to carry IPX packets across a PPP serial link. You need at least
  1506.   version ppp-2.2.0d of the daemon. See the PPP-HOWTO <PPP-HOWTO.html>
  1507.   for details on where to find it. When you compile pppd you must ensure
  1508.   you enable the IPX support by adding the following two lines:
  1509.  
  1510.        IPX_CHANGE = 1
  1511.        USE_MS_DNS = 1
  1512.  
  1513.   to: /usr/src/linux/pppd-2.2.0f/pppd/Makefile.linux.
  1514.  
  1515.   The IPX_CHANGE is what configures the IPX support into PPP.  The
  1516.   USE_MS_DNS define allows Microsoft Windows95 machines to do Name
  1517.   Lookups.
  1518.  
  1519.   The real trick to getting it to work in knowing how to configure it.
  1520.  
  1521.   There are many ways of doing this, but I'm only going to describe the
  1522.   two that I've received any information on. I've tried neither yet, so
  1523.   consider this section experimental, and if you get something to work,
  1524.   please let me know.
  1525.  
  1526.   13.1.  Configuring an IPX/PPP server.
  1527.  
  1528.   The first thing you need to do is configure your Linux machine as an
  1529.   IP/PPP server. Don't panic! This isn't difficult. Again, follow the
  1530.   instructions in the PPP-HOWTO <PPP-HOWTO.html> and you should be
  1531.   pretty much ok. When you have this done there are a couple of simple
  1532.   modifications you need to make to get IPX working over the same
  1533.   configuration.
  1534.  
  1535.   13.1.1.  First steps.
  1536.  
  1537.   One of the first steps you must take is to configure your linux
  1538.   machine as an IPX router as described in the appropriate section
  1539.   earlier in this document.  You won't need to use the ipx_route command
  1540.   for the ppp interface because pppd will configure these for you as it
  1541.   does for IP. When you have the ipxd daemon running it will
  1542.   automatically detect any new IPX interfaces and propogates routes for
  1543.   them. In this way your dialup hosts will be seen by other machines
  1544.   automatically when they connect.
  1545.  
  1546.   13.1.2.  Design.
  1547.  
  1548.   When you are running as a server it will normally be your
  1549.   responsibility to assign network address to each of the PPP links when
  1550.   they are established.  This is an important point, each PPP link will
  1551.   be an IPX network and will have a unique IPX network address. This
  1552.   means that you must decide how you will allocate addresses and what
  1553.   what they will be. A simple convention is to allocate one IPX network
  1554.   address to each serial device that will support IPX/PPP. You could
  1555.   allocate IPX network addresses based on the login id of the connecting
  1556.   user, but I don't see any particularly good reason to do so.
  1557.  
  1558.   I will assume that this is what you have done, and that there are two
  1559.   serial devices (modems) that we will use. The addresses I've assigned
  1560.   in this contrived example are:
  1561.  
  1562.        device IPX Network Address
  1563.        ------ -------------------
  1564.        ttyS0  0xABCDEF00
  1565.        ttyS1  0xABCDEF01
  1566.  
  1567.   13.1.3.  Configure pppd.
  1568.  
  1569.   Configure your /etc/ppp/options.ttyS0 file as follows:
  1570.  
  1571.        ipx-network 0xABCDEF00
  1572.        ipx-node 2:0
  1573.        ipxcp-accept-remote
  1574.  
  1575.   and your /etc/ppp/options.ttyS1 file as:
  1576.  
  1577.        ipx-network 0xABCDEF01
  1578.        ipx-node 3:0
  1579.        ipxcp-accept-remote
  1580.  
  1581.   These will ask pppd to allocate the appropriate IPX network addresses
  1582.   to the link when the link is established, set the local node number to
  1583.   2 or 3 and will let the remote node overwrite what the remote node
  1584.   number with what it thinks it is. Note that each of the addresses are
  1585.   hexadecimal numbers and that 0x is required at the start of the
  1586.   network address, but not required at the start of the node address.
  1587.   There are other places this information could be configured. If you
  1588.   have only one dialin modem then an entry could go into the
  1589.   /etc/ppp/options file. Alternatively this information can be passed on
  1590.   the command line to pppd.
  1591.  
  1592.   13.1.4.  Test the server configuration.
  1593.  
  1594.   To test the configuration you will need to have a client configuration
  1595.   that is known to work. When the caller dials in, logs in and pppd
  1596.   starts it will assign the network address, advise the client of the
  1597.   servers node number and negotiate the clients node number. When this
  1598.   has completed, and after ipxd has detected the new interface the
  1599.   client should be able to establish IPX connections to remote hosts.
  1600.  
  1601.   13.2.  Configuring an IPX/PPP client.
  1602.  
  1603.   In a client configuration, whether or not you configure your Linux
  1604.   machine as an IPX router depends on whether you have a local LAN that
  1605.   you wish to act as an IPX router for. If you are a standalone machine
  1606.   connecting to an IPX/PPP dialin server then you won't need to run
  1607.   ipxd, but if you have a LAN and wish all of the machines on the LAN to
  1608.   make use of the IPX/PPP route then you must configure and run ipxd as
  1609.   described.  This configuration is much simpler because you do not have
  1610.   multiple serial devices to configure.
  1611.  
  1612.   13.2.1.  Configuring pppd
  1613.  
  1614.   The simplest configuration is one that allows the server to supply all
  1615.   of the IPX network configuration information. This configuration would
  1616.   be compatible with the server configuration described above.
  1617.  
  1618.   Again you need to add some options to your /etc/ppp/options file, they
  1619.   are:
  1620.  
  1621.        ipxcp-accept-network
  1622.        ipxcp-accept-remote
  1623.        ipxcp-accept-local
  1624.  
  1625.   These options tell pppd to act completely passively and accept all of
  1626.   the configuration details from the server. You could supply default
  1627.   values here for servers that don't supply details by adding ipx-
  1628.   network and ipx-node entries similar to the server configuration.
  1629.  
  1630.   13.2.2.  Testing the IPX/PPP client.
  1631.  
  1632.   To test the client you will need a known working server to dial into.
  1633.   After you have dialled in and pppd has run you should see the IPX
  1634.   details configured on your ppp0 device when you run the ifconfig
  1635.   command and you should be able to use ncpmount.
  1636.  
  1637.   I'm not sure whether you will have to manually add IPX routes so that
  1638.   you can reach distant fileserver or not. This seems likely. If anyone
  1639.   running this configuration could tell me I'd be grateful.
  1640.  
  1641.   14.  IPX tunnel over IP
  1642.  
  1643.   Many of you will be in a situation where you have two Novell Local
  1644.   Area Netorks with only an IP connection between them. How do you play
  1645.   multiplayer deathmatch DOOM for DOS via this arrangement you might ask
  1646.   ? Andreas Godzina <ag@agsc.han.de> has an answer for you in the form
  1647.   of ipxtunnel.
  1648.  
  1649.   ipxtunnel provides a bridge-like facility for IPX by allowing IPX
  1650.   packets to be encapsulated with tcp/ip datagrams so that they can be
  1651.   carried by a tcp/ip connection. It listens for IPX packets and when it
  1652.   hears one it wraps it within a tcp/ip datagram and routes it to a
  1653.   remote IP address that you specify. For this to work of course the
  1654.   machine that you route the encapsulated IPX must also be running a
  1655.   copy of the same version of ipxtunnel as you.
  1656.  
  1657.   14.1.  Obtaining ipxtunnel
  1658.  
  1659.   You can obtain ipxtunnel from sunsite.unc.edu
  1660.   <ftp://sunsite.unc.edu/pub/Linux/system/network/daemons> or mirror
  1661.   sites.
  1662.  
  1663.   14.2.  Building ipxtunnel
  1664.  
  1665.   ipxtunnel built cleanly for me using the following commands:
  1666.  
  1667.        # cd /usr/src
  1668.        # tar xvfz .../ipxtunnel.tgz
  1669.        # cd ipxtunnel
  1670.        # make
  1671.  
  1672.   14.3.  Configuring ipxtunnel
  1673.  
  1674.   Configuration for ipxtunnel is easy. Lets say that your friends
  1675.   machine is gau.somewhere.com and your machine is called gim.sw.edu.
  1676.   ipxtunnel uses a configuration file called /etc/ipxtunnel.conf. This
  1677.   file allows you to specify the default UDP port to use for the tcp/ip
  1678.   connection, where to send the encapsulated data and which of your
  1679.   local interfaces ipxtunnel should listen on and deliver IPX packets
  1680.   to.
  1681.  
  1682.   A simple configuration file would look like the following:
  1683.  
  1684.        #
  1685.        # /etc/ipxtunnel.conf for gim.sw.edu
  1686.        #
  1687.        # The UDP port to use:                       (default 7666)
  1688.        port 7777
  1689.        #
  1690.        # The remote machine to send IPX packets to: (no default)
  1691.        remote gau.somewhere.com
  1692.        #
  1693.        # The local interfaces to listen for IPX on: (default eth0)
  1694.        interface eth0
  1695.        interface eth1
  1696.  
  1697.   Obviously the other machine would have a similar configuration file
  1698.   specifying this machine as a remote host.
  1699.  
  1700.   14.4.  Testing and using ipxtunnel
  1701.  
  1702.   ipxtunnel acts like an IPX bridge, so the IPX networks at either end
  1703.   of the link should probably be the same. Andreas has never tested the
  1704.   ipxtunnel in an environment that actually supports Novell file servers
  1705.   so if you do try this in a real environment let Andreas know if it
  1706.   works or not.
  1707.  
  1708.   If the ipxtunnel is working you should be able to start your DOOM
  1709.   machines up at each end of the link running IPX mode and they should
  1710.   see each other.
  1711.  
  1712.   Andreas has only used this code over good high speed lines and he
  1713.   makes no claim as to its performance when your link is low speed.
  1714.   Again, let him know what works for you and what doesn't.
  1715.  
  1716.   15.  Commercial IPX support for Linux.
  1717.  
  1718.   15.1.  Caldera'a Network Desktop
  1719.  
  1720.   Caldera Inc., produce a Linux distribution that features a range of
  1721.   commercially supported enhancements including fully functional Novell
  1722.   NetWare client support. The base distribution is the well respected
  1723.   Red Hat Linux Distribution and Caldera have added their "Network
  1724.   Desktop" products to this.  The NetWare support provides a fully
  1725.   featured Novell NetWare client built on technology licensed from
  1726.   Novell Corporation. The client provides full client access to Novell
  1727.   3.x and 4.x fileservers and includes features such as NetWare
  1728.   Directory Service (NDS) and RSA encryption.
  1729.  
  1730.   You can obtain much more information and ordering details from the:
  1731.   Caldera Inc Web Server <http://www.caldera.com/>.
  1732.  
  1733.   If you work within a Netware 4.x and/or NDS environment then the
  1734.   Caldera Netware Client is the only solution available.
  1735.  
  1736.   If you have a business critical application for Novell support for
  1737.   Linux then the Caldera product should be something you take a close
  1738.   look at.
  1739.  
  1740.   16.  Some Frequently Asked Questions
  1741.  
  1742.      Where can I find commercially supported IPX software for Linux ?
  1743.         The Caldera Corporation offers a fully licensed and fully
  1744.         supported Netware 3.x and 4.x client. You can obtain information
  1745.         about it from the Caldera Inc Web Server
  1746.         <http://www.caldera.com/>.
  1747.  
  1748.      Does the IPX software work with Arcnet/Token Ring/etc. ?
  1749.         The Linux IPX software does work with ArcNet and Token Ring
  1750.         interfaces.  I haven't heard of anyone trying it with AX.25 yet.
  1751.         Configuration is the same as for configuring for ethernet except
  1752.         you will have to substitute appropriate device names in place of
  1753.         'eth0' and appopriate hardware addresses where necessary.
  1754.      How do I configure more than one IPX interface ?
  1755.         If you have more than one interface in your machine you should
  1756.         use the ipx_interface command to manually configure each one,
  1757.         you should not use the `plug n play' configuration.
  1758.  
  1759.      How do I choose IPX addresses ?
  1760.         IPX networking is similar, but not identical to, IP networking.
  1761.         A major difference is the way that addresses are used. IPX does
  1762.         not use the concept of subnetworking and so the sort of
  1763.         associations that you have between network addresses and
  1764.         networks is different. The rules are fairly simple:
  1765.  
  1766.      ╖  Every IPX network address must be unique on a wide area network.
  1767.         This includes Internal Network Addresses. Many organisations
  1768.         using IPX over a wide area network will have some sort of
  1769.         addressing standard that you should follow.
  1770.  
  1771.      ╖  Every Host address on an individual network must be unique. This
  1772.         means that every host on each IPX network must have a uniquely
  1773.         assigned address. In the case of ethernet network this isn't
  1774.         difficult as the cards each have a unique address. In the case
  1775.         of IPX/PPP this means you must ensure that you allocate unique
  1776.         addresses to all hosts on the network, irrespective of which end
  1777.         of the link(s) they are connected. Host address do not need to
  1778.         be unique across a wide area network as the network address is
  1779.         used in combination with the host address to uniquely identify a
  1780.         host.
  1781.  
  1782.      What are frame types, which should I use ?
  1783.         There are a variety of frame types in use over which you can run
  1784.         IPX.  The most common of these are described in the 'common
  1785.         terms' section of this document (under the `Frame Type entry').
  1786.  
  1787.         If you are installing your machine on an existing network then
  1788.         you must use whatever is already in use to allow you to
  1789.         interwork with the other hosts on the network, but if the
  1790.         installation is a brand new network you can use any of a range
  1791.         of protocols to carry  your IPX traffic. My recommendation if
  1792.         you are configuring a brand new network and you need to carry
  1793.         both IPX and IP traffic is to use the Ethernet_II frame type.
  1794.  
  1795.      My Windows95 machines mess up my frame type autodetection ?
  1796.         Apparently they can, yeah. I could make nasty comments, but
  1797.         instead I'll just suggest that you use the manual frame type
  1798.         configuration instead of the automatic one. It is probably the
  1799.         better way anyway.
  1800.  
  1801.      Why do I get the message `invalid argument' when I configure IPX ?
  1802.         You are probably not running a kernel that supports IPX, either
  1803.         recompile your kernel so it does, or double check that you have
  1804.         actually used lilo to install and run the new kernel.
  1805.  
  1806.      Why do I get the message `package not installed' when I configure
  1807.         IPX ?
  1808.         You are probably not running a kernel that supports IPX, either
  1809.         recompile your kernel so it does, or double check that you have
  1810.         actually used lilo to install and run the new kernel.
  1811.  
  1812.      Why do I get the message `IPX support not in kernel' from pppd ?
  1813.         You've probably compiled IPX as a module and not ensured that it
  1814.         was loaded before started pppd.
  1815.  
  1816.      How do I NFS export a mounted NCP filesystem ?
  1817.         To use NFS to export an NCP filesystem you must mount it using
  1818.         the ncpmount -V option. This option allows you to mount only one
  1819.         volume of a fileserver instead of the usual mounting of all of
  1820.         them.  When you do this your NFS daemon will allow you to export
  1821.         that filesystem in the usual way.
  1822.  
  1823.      Why doesn't slist work when I have an internel network with
  1824.         mars_nwe ?
  1825.         You must have the get nearest server enabled.  That is, entry
  1826.         401 in /etc/nwserv.conf should be 0 unless you have a reason for
  1827.         not responding to get nearest servers.  If you just want slist
  1828.         to work and not respond to every get nearest server request,
  1829.         include your internal network and node number in
  1830.         /etc/nwserv.stations and set entry 401 in /etc/nwserv.conf to 2.
  1831.  
  1832.      Does ncpfs package work with mars_nwe ?
  1833.         Martin and Volker's code is slowly beginning to converge. Recent
  1834.         versions of mars_nwe have an option to enable it to work with
  1835.         ncpfs.  You must enable the WITH_NAME_SPACE_CALLS in the
  1836.         mars_nwe config.h file.
  1837.  
  1838.      Is there any free DOS software to work with mars_nwe ?
  1839.         A contrived question deserves a contrived answer. I'm glad you
  1840.         asked, Martin has a package that he distributes alongside his
  1841.         mars_nwe package that offers free DOS client support for the
  1842.         mars_nwe server.  You can find it at the same sites as the
  1843.         server, and it will be called mars_dosutils-0.01.tgz. It
  1844.         includes C source code for programs such as slist.exe,
  1845.         login.exe, map.exe etc. The source is compilable with
  1846.         Borland(tm) C.
  1847.  
  1848.   17.  Copyright Message.
  1849.  
  1850.   The IPX-HOWTO, a guide to software supporting the IPX protocol for
  1851.   Linux.  Copyright (c) 1995 Terry Dawson.
  1852.  
  1853.   This program is free software; you can redistribute it and/or modify
  1854.   it under the terms of the GNU General Public License as published by
  1855.   the Free Software Foundation; either version 2 of the License, or (at
  1856.   your option) any later version.
  1857.  
  1858.   This program is distributed in the hope that it will be useful, but
  1859.   WITHOUT ANY WARRANTY; without even the implied warranty of
  1860.   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  1861.   General Public License for more details.
  1862.  
  1863.   You should have received a copy of the GNU General Public License
  1864.   along with this program; if not, write to the:
  1865.  
  1866.   Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
  1867.   USA.
  1868.  
  1869.   18.  Miscellaneous and Acknowledgements.
  1870.  
  1871.   David E. Storey <dave@tamos.gmu.edu> and Volker Lendecke
  1872.   <lendecke@namu01.gwdg.de> both assisted greatly by supplying me with
  1873.   information for this document.  Gilbert Callaghan
  1874.   <gilbert@pokey.inviso.com>, David Higgins <dave@infra.com> and Chad
  1875.   Robinson <chadr@brtgate.brttech.com> each contributed information on
  1876.   configuring IPX/PPP.  Bennie Venter <bjv@Gil-galad.paradigm-sa.com>
  1877.   contributed some useful information relating to frame types.
  1878.   Christopher Wall <vergil@idir.net contributed some useful suggestions
  1879.   to improve the readability and layout of the document.  Axel Boldt
  1880.   <boldt@math.ucsb.edu> contributed some useful suggestions and
  1881.   feedback.  Erik D. Olson <eriko@wrq.com> provided some useful feedback
  1882.   and information on configuring PPP for IPX.  Brian King
  1883.   <root@brian.library.dal.ca> contributed a question for the FAQ
  1884.   section.
  1885.  
  1886.   "NetWare" is a registered trademark of the Novell Corporation
  1887.   <http://www.novell.com/>.  "Caldera" is a registered trademark of the
  1888.   Caldera Corporation <http://www.caldera.com/>.
  1889.  
  1890.   regards Terry Dawson, VK2KTJ.
  1891.  
  1892.   <terry@perf.no.itg.telstra.com.au>
  1893.  
  1894.